CLOB Read (Public)

Price history (PM wire shape — {history: [{t, p}]}).

Price history for a single token — PM wire parity.

Mirrors Polymarket’s GET /prices-history?market=... (P0 eval finding, 2026-06-10): accepts PM’s REQUIRED market= param (previously 422’d as “missing token_id”), returns PM’s exact {"history": [{"t": int, "p": float}]} envelope by default (previously a bare OHLCV array that KeyError’d resp["history"] on ported code), supports startTs/endTs/fidelity, and 400s (not 422s) on the missing-param case with PM’s live error message verbatim.

Public endpoint — no authentication required.

GET

/

v1

/

prices-history

Price history (PM wire shape — {history: [{t, p}]}).

curl --request GET \
  --url https://api.polysimulator.com/v1/prices-history

{
  "history": [
    {
      "t": 123,
      "p": 123
    }
  ]
}

Query Parameters

market

string | null

The market to query — a CLOB outcome TOKEN id (PM's param name; on real PM this also takes the token id despite the name). REQUIRED unless the legacy token_id alias is used.

token_id

string | null

Polysim legacy alias for market (pre-2026-06-11 the endpoint ONLY accepted this name, breaking py-clob-client ports). market wins when both are present.

interval

string | null

PM interval enum: 1h, 6h, 1d, 1w, 1m (one MONTH), max, all. Defaults to 1h when neither startTs nor endTs is given; omitted upstream when an explicit time range is supplied.

startTs

number | null

Only items after this unix-seconds timestamp.

endTs

number | null

Only items before this unix-seconds timestamp.

fidelity

integer | null

Bucket accuracy in minutes (PM param; default 1).

Required range: x >= 1

format

string

default:pm

pm (default): PM's exact {"history": [{"t", "p"}]} envelope with p as a JSON number. ohlcv: the legacy polysim bare array of {t, o, h, l, c} string-valued points (pre-2026-06-11 default — NOT PM wire-compatible; kept for back-compat).

Response

Successful Response

PmPriceHistory · object
CandlePoint · object[]

PM's exact GET /prices-history envelope: {"history": [...]}.

history

PmPricePoint · object[]

required

Show child attributes

Get Server TimeReturn the current server time as a bare Unix-seconds integer. PM-CLOB canonical (PM-compat round 2, audit 2026-05-19 AF-3): Polymarket emits ``GET /time`` as a bare JSON integer (``1779147906``), NOT as an object (``{"server_time":1779147906}``). py-clob-client does ``int(response.text)`` on this surface; the object form TypeErrors on every startup health check. MIGRATION NOTE (PR #1509 Copilot review, 2026-05-19): pre-AF-3 polysim wrapped this in ``{"server_time": N}``. Clients that read the old shape used ``resp.json()["server_time"]`` to extract the integer; under the new bare-integer form the equivalent is ``int(resp.text)`` (what py-clob-client does) or ``resp.json()`` (which now returns the int directly because the body parses as a JSON integer). Code that previously did ``int(resp.json()["server_time"])`` will KeyError under the new shape — clients need to switch to one of the bare forms above.

Price history (PM wire shape — {history: [{t, p}]}).

curl --request GET \
  --url https://api.polysimulator.com/v1/prices-history

{
  "history": [
    {
      "t": 123,
      "p": 123
    }
  ]
}